home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Amiga Amateur Radio User Group / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].zip / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].adf / DisView / !!README.1ST next >
Text File  |  1995-05-29  |  10KB  |  301 lines
  1. ============                                        DISview [518]
  2. !!README.1ST
  3. ============
  4.  
  5.  
  6. ------------
  7. INTRODUCTION
  8. ------------
  9. "DISview" is a reference documentation package for version 2.16
  10. of the KA9Q Network Operating System (NET) from Demon Internet 
  11. Ltd, the UK's number one dial-up Internet Service Provider.
  12.  
  13. This is version [518] of "DISview"; that is, it was released in:
  14.                  |||
  15.   year 199[5]----+||
  16.                   ||
  17.     week [18]-----++
  18.  
  19. This README file describes how to install the package and 
  20. provides general background information.
  21.  
  22.  
  23.  
  24. ----------------------------
  25. "DISview" [518] Distribution
  26. ----------------------------
  27. This version of "DISview" comprises two files:
  28.  
  29.   DISVIEW.TXT    Brief introduction to "DISview".
  30.  
  31.   DISVW518.ZIP   The "DISview" [518] distribution.
  32.                  Contains all the "DISview" documentation files
  33.                  and the "VIEW" on-line file viewer.
  34.  
  35.  
  36.  
  37. ----------------------
  38. "DISview" INSTALLATION
  39. ----------------------
  40. -------------
  41. Preliminaries
  42. -------------
  43. Hardware Requirements:  80x86 machine with at least 640 KB RAM
  44.                         Less than 1MB of hard disk storage.
  45.  
  46. Software Prerequisites: DOS version 3 or later.
  47.  
  48. *****  The installation process doesn't at any time read or alter
  49. your AUTOEXEC.BAT or CONFIG.SYS file.  However, if you want to
  50. start "VIEW" (the on-line viewer program) automatically each time
  51. you boot the system, you will need to make a minor addition to
  52. AUTOEXEC.BAT.
  53.  
  54.  
  55. ------------
  56. Installation
  57. ------------
  58. To install "DISview", first create a new subdirectory for it -- 
  59. as a suggestion, if the Demon root directory is C:\DEMON, then
  60. create C:\DEMON\DISVIEW. 
  61.  
  62. Now download DISVW518.ZIP into the "DISview" subdirectory and 
  63. unzip the file. You can then delete DISVW518.ZIP as it is no 
  64. longer required.
  65.  
  66.  
  67. --------------------
  68. Editing AUTOEXEC.BAT 
  69. --------------------
  70. Having unzipped DISVW518.ZIP, you should edit AUTOEXEC.BAT if
  71. you want to load the "VIEW" TSR automatically at boot time.
  72.  
  73. "VIEW" lets you display text files whilst connected on-line to 
  74. Demon, giving you instant help with NET commands just when you
  75. need it most.
  76.  
  77. To load "VIEW" automatically at boot time, add the following line
  78. at the end of AUTOEXEC.BAT:
  79. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80. C:\DEMON\DISVIEW\VIEW
  81.  
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. Then reboot the system. When the system starts running again, you
  85. should see the following message:
  86.  
  87.     ....................................................
  88.     : Loading VIEW - Clockwork's Resident File Viewer. :
  89.     : To activate press:-       RShift and SPC         :
  90.     :..................................................:
  91.  
  92. Test the operation of "VIEW" by holding down the right shift key
  93. and pressing the space bar. The Clockwork View introduction screen
  94. should appear.  Use the PgDn and PgUp keys to examine the help 
  95. menus.
  96.  
  97. Then test the file viewer, by pressing F3.  The prompt
  98.  
  99.        "Load file: *.*"
  100.  
  101. should then appear.  Press ENTER.  This should pop up a list of
  102. files in the current directory.  Move the arrow keys up or down
  103. to select a particular file, then press ENTER again.  The
  104. selected file should now appear.
  105.  
  106. Use the "G" and/or "H" key to change the display format if
  107. necessary.  
  108.  
  109. To view the "DISview" file set, press F3 then enter the file
  110. descriptor:
  111.  
  112.        "Load file: C:\DEMON\DISVIEW\*.*"
  113.  
  114. Finally, press ESCAPE to exit from "VIEW".
  115.  
  116. This completes the installation of "DISview".
  117.  
  118.  
  119. -----------
  120. Conventions
  121. -----------
  122. To obtain overall consistency throughout "DISview", a number of
  123. conventions have been adopted.
  124.  
  125. ---------------
  126. Parameter Names
  127. ---------------
  128. Because the NET package contains software modules originating
  129. from several different sources, the documentation which describes
  130. them inevitably contains a number of inconsistencies.  For
  131. example, the words "label" and "interface" apparently describe
  132. different objects, whereas in actuality they are the same thing.
  133. On the other hand, the word "address" can have different
  134. meanings, depending on the command.
  135.  
  136. In "DISview", the names of these parameters have been rationalised
  137. to produce a consistent command set.  The parameters which often
  138. cause confusion are to do with names, addresses and interfaces.
  139. These are now defined as follows:
  140.  
  141. Network name and address parameters
  142. -----------------------------------
  143.  
  144.  
  145.        <hostname> -----------+          +------- <domain_name>
  146.                              |          |
  147.                           <------> <--------->
  148.   email_address ==>   ian@dowrmain.demon.co.uk
  149.                       <-> <------------------>
  150.                        |           |
  151.        <username> -----+           +------------- <nodename>
  152.                                    |
  153.                           <------------------>
  154.                           dowrmain.demon.co.uk.
  155.                           <------------------->
  156.                                    |
  157.        <fqdn> ---------------------+
  158.        (fully qualified domain name)
  159.  
  160.  
  161.  
  162.   <hostname>      the local name of a machine   (e.g. "dowrmain")
  163.  
  164.   <domain_name>   the name of the DNS domain (e.g. "demon.co.uk")
  165.  
  166.   <nodename>      the combination of <hostname> and <domain_name>
  167.                                     (e.g. "dowrmain.demon.co.uk")
  168.  
  169.   <fqdn>          the fully qualified domain name; i.e. the
  170.                   <nodename> followed by a terminating dot.
  171.                                    (e.g. "dowrmain.demon.co.uk.")
  172.                   (FQDNs only appear in DNS-related files)
  173.    
  174.   <ip_address>    an Internet address    (e.g. "158.152.123.251")
  175.  
  176.   <username>      a user at a computer               (e.g. "ian")
  177.  
  178.   <interface>     a device interface name            (e.g. "sl0")
  179.  
  180.   <ioaddress>     a device I/O base address       (e.g.  "0x3f8")
  181.  
  182.   <vector>        an IRQ level                         (e.g. "4")
  183.  
  184. The word "hostid" is not used at all, to avoid confusion with the
  185. Unix command of the same name.
  186.  
  187.  
  188. Interface Names
  189. ---------------
  190. You can choose any name for a device interface. In "DISview", the
  191. following names are used:
  192.  
  193.   "sl0"  for a serial interface (e.g. COM1, COM2 etc). 
  194.          ("sl0" is letter "ess", letter "ell", digit zero,
  195.           short for "serial link zero").
  196.  
  197.   "en0"  for an Ethernet interface.
  198.  
  199.  
  200.  
  201. Directory and Files: Names and Paths
  202. ------------------------------------
  203. In "DISview" documentation, UPPER-CASE directory and filenames
  204. refer to DOS files, and paths use backslashes; e.g.
  205.  
  206.      C:\DEMON
  207.  
  208. Directory and filenames in lower-case refer to NET files, and
  209. paths use forward slashes; e.g. a NET 'record' command looks
  210. something like this:
  211.  
  212.      record temp/rec123.dat
  213.  
  214. The tilde ~ character refers to the Demon root directory. Thus,
  215. for example, if the Demon root is at C:\DEMON, then the NET file
  216. ~/spool/rewrite is really the DOS file C:\DEMON\SPOOL\REWRITE.
  217.  
  218.  
  219.  
  220. -------------------
  221. Release Information
  222. -------------------
  223. Full details of the contents of the current release of "DISview" 
  224. are included in the file "!DISVIEW.HIS.
  225.  
  226.  
  227.  
  228. ----------------
  229. Acknowledgements
  230. ----------------
  231. "DISview" is based on the work of many, many people, and in the
  232. list below I hope I have included all of those who have written
  233. NET software and documentation in the past.
  234.  
  235. However, if you recognise some of your work but have not been
  236. acknowledged here, please don't be offended.  It's simply that I
  237. did not know you had written it.
  238.  
  239. First, in strict surname order, the work of the following people
  240. in developing and documenting the original (pre-Demon) versions 
  241. of NET is acknowledged:
  242.  
  243. Phil Karn, KA9Q     (Who said the alphabet doesn't begin with K?)
  244.  
  245. John Ackermann            Kelvin Hill
  246. Hayden Bate                     Gareth Howell
  247. Dave Brooke                     Pavel Jalocha
  248. Mike Chace                      Brian Kantor
  249. Tom Clark                       Anders Klemets
  250. Mike Dent                       Wally Linstruth
  251. D R Evans                       Peter Meiring
  252. Gary Ford                       Russell Nelson
  253. Dan Frank                       Johan Reinalda
  254. Bdale Garbee                    Bill Simpson
  255. Fred Goldstein                  Mike Stockett
  256. Gerard van der Grinten          Paul Taylor
  257. Allen Gwinn                     Stanley Wilson
  258. Charles Hedricks
  259.  
  260.  
  261. Then came the Demons:
  262.  
  263. Ashley Allerton       <ashley@pinwood.demon.co.uk>
  264. Marcus Bainbridge     <marcus@guitar.demon.co.uk>
  265. Gordon Beck           <gordon@galisant.demon.co.uk>
  266. Michael Bernardi      <mike@childsoc.demon.co.uk>
  267. John Bradley          <john@gst-soft.demon.co.uk>
  268. Rob B?                <rjb@sound.demon.co.uk>
  269. Richard Clayton       <tuning@locomotive.com>
  270. Grahame Davies        <grahame@walm.demon.co.uk>
  271. Iain Douglas          <iain@nomed.demon.co.uk>
  272. Tim Illingworth       <tim@smof.demon.co.uk>
  273. Phineas R John        <phineas@gully.demon.co.uk>
  274. Brian Hamilton Kelly  <bhk@dsl.co.uk>
  275. Nikki Locke           <nikki@trmphrst.demon.co.uk>
  276. Malcolm Muir          <malcolm@thokk.demon.co.uk>
  277. Paul Overton          <paul@g0mhd.demon.co.uk>
  278. Richard Palmer        <tuning@blackbrd.demon.co.uk>
  279. Iain Paton            <lonewolf@sphere.demon.co.uk>
  280. Mark Rogers           <mcr@holly.demon.co.uk>
  281. Steve Rogers          <steverogers@thebeast.demon.co.uk>
  282. Paul Smith            <paul@wolf.demon.co.uk>
  283. Chris Sowden          <csowden@mouse.demon.co.uk>
  284. Cliff Stanford        <cms@home.demon.co.uk>
  285. Giles Todd            <giles@hel.demon.co.uk>
  286. Mark Turner           <mt@kram.demon.co.uk>
  287. Ian Young             <ian@rats.demon.co.uk>
  288.  
  289. (If you know of anybody I've omitted from this list, please let 
  290. me know so that I can include them in the next release).
  291.  
  292.  
  293. Finally, as this is the first release of "DISview", there will
  294. inevitably be (hopefully few) errors and omissions. If you have
  295. any comments/suggestions/criticisms/contributions, please email
  296. me. Your input will be most welcome.
  297.  
  298.  
  299. Ian Wade  <ian@dowrmain.demon.co.uk>
  300. May 1995
  301.